home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / wterm107.zip / WTERM.DOC < prev    next >
Text File  |  1991-03-30  |  36KB  |  751 lines
  1.          ┌──────────────────────────────────────────────────────┐
  2.          │                                                      │
  3.          │   \/\/term  (C)Copyright \/\/alter Cox 1990, 1991.   │
  4.          │                All rights reserved.                  │
  5.          │                                                      │
  6.          │               \/\/term  DOCumentation                │
  7.          │                                                      │
  8.          │                    Version 1.07                      │
  9.          └──────────────────────────────────────────────────────┘
  10.  
  11.  
  12.          Introduction
  13.  
  14.          WTERM is a bare bones comm program that should be
  15.          adequate for use with most bulletin boards.  Users with
  16.          limited disk and/or memory may find it especially
  17.          useful.  There is no script language and no terminal
  18.          emulation.  There is no built-in ANSI support so you
  19.          must load an ANSI driver in your CONFIG.SYS file.
  20.  
  21.          There is no scrollback buffer, however WTERM writes a
  22.          file named WTERM.LOG and strips ANSI from it.  You can
  23.          use LIST to view this file and aside from the slight
  24.          delay to load it, it works better than a scrollback
  25.          buffer with search capabilities.  The log can be toggled
  26.          on and off if you desire.  More on this later.
  27.  
  28.          No file transfer protocols are built-in.  WTERM relies
  29.          on external protocol drivers like DSZ (tm) and PCZ for
  30.          file transfers.  DSZ is shareware and PCZ is Public
  31.          Domain.  The Zmodem upload and download strings are
  32.          detected automatically.  The Zmodem driver you have
  33.          configured is then called.
  34.  
  35.          A 16550AN UART is automatically detected and activated
  36.          with the FIFO trigger level set for 8.
  37.  
  38.          An editor of your choice may be configured and loaded at
  39.          the touch of a function key.  A few good free editors
  40.          are EDWIN, Turbo Powered Editor(TPE), and VDE.  For a
  41.          tiny free editor, you might want to take a look at TED
  42.          by PC Magazine.  Another fine shareware editor which
  43.          many seem to be using is Qedit (tm).
  44.  
  45.  
  46.  
  47.          Setup
  48.  
  49.          WTERM has an internal setup utility.  If no WTERM.CFG
  50.          file exists when WTERM loads, it automatically loads
  51.          setup and will not let you out of it until you write a
  52.          setup file.  When you wish to view or change the
  53.          configuration, press ALT-S.  Use the capital letter
  54.          associated with any parameter to change that parameter.
  55.          First press U and enter your name.  This is the name
  56.          that will be transmitted by WTERM when you press the F2
  57.          key.  A line will appear in reverse video showing how
  58.          many characters are allowed for this entry.  Enter your
  59.          name and press enter.  An enter will be appended to the
  60.          name automatically.  In the next line, configure the
  61.          drive, path and filename of the editor you wish to use.
  62.          See the section below on line editing for an
  63.          explaination of how the line editor works.
  64.  
  65.  
  66.          Setup - Modem
  67.  
  68.          Port, Speed, pArity, Bits, and sTopbits are all toggles.
  69.          Press the capital letter for a given entry to select the
  70.          value you desire.
  71.  
  72.          Modem initialization string also uses the line editor.
  73.          To send an enter (carriage return) use |.  For a one
  74.          second pause, use a ~.  If you have been using another
  75.          comm program, use the modem initialization string you
  76.          used for it.  The initialization string included in the
  77.          example works with my modem but is mainly there to fill
  78.          the space and give an example.  There are too many
  79.          modems out there to come up with one string that works
  80.          for all and no attempt has been made to do so.  Consult
  81.          the manual that came with your modem for the proper
  82.          commands.
  83.  
  84.          HST users NOTE:  The HST has trouble loosing it's
  85.          initialization after an ALT-H, so sending the
  86.          initialization afterwards was added for it.  A delay was
  87.          also needed, so you may need to add one or two "~" in
  88.          front of the initialization string.
  89.  
  90.          When a connection is made, WTERM looks at the CONNECT
  91.          string returned and tries to switch to the speed of
  92.          connection.  Some users of fast modems wish to lock
  93.          their comm port at a higher rate and let their modem
  94.          switch to the speed of the line.  Lockbaud set to on
  95.          will prevent WTERM from changing the port speed.  If set
  96.          to no, it will set the port to the speed of the connect.
  97.  
  98.          You may configure a dialing prefix, the string WTERM
  99.          will send to the modem before sending the number to
  100.          dial.  Users with Hayes compatible modems with touchtone
  101.          phones will not have to change the default ATDT.  If
  102.          your line only supports pulse dial, change it to ATDP
  103.          instead.  You may add a | in front of the dialing prefix
  104.          to make sure the command is seen by the modem as the
  105.          first characters in a line.
  106.  
  107.          WTERM has both Xoff/Xon and hardware (RTS) flow control.
  108.          The F key toggles from None, to Xoff/Xon, to Hardware,
  109.          to both and back to none.  Flow control works only one
  110.          direction.  It prevents the modem from overrunning it
  111.          but doesn't pay attention to CTS to prevent overruning
  112.          the modem.  Since keyboard input isn't fast enough to
  113.          overrun anything and ASCII transmits can use the pace
  114.          character timing, it shouldn't be needed.  Users of
  115.          modems faster than 2400 baud should set hardware flow
  116.          control.
  117.  
  118.  
  119.          Setup - Protocols
  120.  
  121.          WTERM detects the start of a Zmodem download or upload
  122.          and calls the protocol you have configured.  If you
  123.          chose to use a protocol other than Zmodem, you can turn
  124.          this option off by setting autoZmodem to no.  If this
  125.          feature is desired, leave it at the default yes.
  126.  
  127.          The next option, asCii pace time, sets the number of
  128.          msecs. between characters transmitted with an ALT-T
  129.          transmit or with an ALT-M message upload.  You can set
  130.          this time between 0 (no delay) and 999 msec. - very
  131.          extreme.  Adjust this speed if the boards you use have
  132.          difficulty with your speed of transmission.
  133.  
  134.          Options 1 and 3 set the drive and path for your default
  135.          up and download directories.  When you begin an upload,
  136.          WTERM changes to the directory you enter in 1.  For a
  137.          download it switches to the drive and directory you have
  138.          configured in 3.  Using this option and the %S (speed)
  139.          and %P (port), you can set up your protocol (such as
  140.          PCZ) to up and download without using batch files.  See
  141.          the section on file transfers below for more
  142.          information.
  143.  
  144.          Option 2 sets up the external protocol driver used for
  145.          an upload.  Enter the name of the program and any
  146.          options needed.  When WTERM detects the start of a
  147.          Zmodem upload, it checks to see if the last filename it
  148.          saw is in the upload directory.  If it is, it does not
  149.          prompt for a filename but immediately starts the upload.
  150.          If you press PgUp before the upload starts, it prompts
  151.          for a filename and adds the name of the last file seen
  152.          as a default which you can edit, or just hit return to
  153.          start the upload.  The name of the default directory to
  154.          be used is displayed in the filename prompt, the one
  155.          configured in 1.  It can be overridden by specifing the
  156.          path.  This of course assumes that you have not set
  157.          autoZmodem to no.  If your protocol driver is not in
  158.          your path or in your upload directory, make sure you
  159.          enter the drive and path as well.  If you need to tell
  160.          the driver